home *** CD-ROM | disk | FTP | other *** search
/ Aminet 35 / Aminet 35 (2000)(Schatztruhe)[!][Feb 2000].iso / Aminet / util / arc / CheckX.lha / CheckX / CheckX.readme < prev    next >
Encoding:
Text File  |  1999-12-06  |  7.9 KB  |  158 lines
  1. Short:    V1.68 Check for Archives/Packers/Viruses
  2. Uploader: stoecker@amigaworld.com (Dirk Stoecker)
  3. Author:   stoecker@amigaworld.com (Dirk Stoecker)
  4. Type:     util/arc
  5. Requires: util/arc/xadmaster.lha
  6.           util/virus/xvsLibrary.lha
  7.           util/pack/xfdmaster.lha
  8.           util/pack/xpk_User.lha
  9. Version:  1.68
  10.  
  11. This program uses xfdmaster.library (see util/pack/xfdmaster.lha) and
  12. xvs.library (util/virus/xvsLibrary.lha) for packer and virus scanning.
  13. The xadmaster.library (see util/arc/xadmaster.lha) is used to dearchive
  14. file and disk archives.
  15.  
  16. NOTE: xadmaster.library is Shareware, so think about registering when
  17. using this utility together with that library (and without it's nearly
  18. useless). See conditions in xadmaster.library distribution.
  19.  
  20. The xfdmaster.library is needed to run the utility. The xvs.library and
  21. xadmaster.library are recommended! The xpkmaster.library is needed with
  22. ASKPWD password only (and to decrunch XPKF files).
  23.  
  24. CheckX unpacks archives and packed files as deep as possible:
  25.  - you can unarchive a crunched archive as well
  26.  - multiple crunched files can be decrunched
  27.  - multiple archives can be extracted
  28.  - multiple disk archives can be extracted
  29.  - linked and crunched and archived files are no problem
  30.  
  31. This all depends mainly on your memory size! If have around 50MB and have
  32. only little problems with really large files.
  33.  
  34. Call CheckX with a ? and you get following argument list:
  35.  FROM,LOG,SAVE/K,ALL/S,ASKPWD/S,AUTOMOUNT/S,PRINTALL/S,PRINTEXEC/S,
  36.  NODECRUNCH/S,NOUNLINK/S,NOUNARCHIVE/S,NOUNTRACK/S,NOTRACKCUT/S,NOSTRIP/S,
  37.  NOVIRUS/S,DEBUG/S,QUIET/S
  38.  
  39. Enter a ? again and you get a short doc:
  40.  FROM        source file or directory - may contain patterns
  41.  LOG         log file name
  42.  SAVE        directory, where decrunched files are saved
  43.  ALL         scan deep into directories
  44.  ASKPWD      ask for password when needed (needs xpkmaster.library)
  45.  PRINTALL    print all filenames
  46.  PRINTEXEC   print names of all executable files
  47.  AUTOMOUNT   automatically mount RDx: device when needed
  48.  NODECRUNCH  do not decrunch files with xfdmaster
  49.  NOUNLINK    do not unlink files with xfdmaster
  50.  NOUNARCHIVE do not call archiver for unarchiving file archives
  51.  NOUNTRACK   do not call archiver for unarchiving track archives
  52.  NOTRACKCUT  do not call archiver for partially track archives
  53.  NOSTRIP     do not strip useless hunks
  54.  NOVIRUS     do not scan with xvs.library for viruses
  55.  DEBUG       also output texts to serial debug engine
  56.  QUIET       do not output texts to console
  57.  
  58. A bit more explanation:
  59. LOG         The output is written to a file as well as to the standard
  60.             output stream. The main purpose CheckX was written for is
  61.             to scan for crunched files and to test the decrunch
  62.             routines. So the logging may take some more time, but is
  63.             very stable, as the last log-entry is always the file which
  64.             possibly crashed the machine.
  65.             The logfile can be accessed by other programs for read and write
  66.             the whole time CheckX works (and surely after that). But writing
  67.             is not recommended, as this may produce a corrupted file.
  68. SAVE        If this keyword is given, all uncrunched/unlinked/stripped
  69.             files will be saved in the directory given with that keyword.
  70.             The directory must already exist! Sub directories are created
  71.             automatically.
  72.             If files are unlinked, they get saved with .1, .2, ...
  73.             extensions. Address crunched files are not saved. Use
  74.             xfdDecrunchAddr or xfdDecrunch to do so.
  75. AUTOMOUNT   To unarchive disk archives (DMS, Zoom) a destination device
  76.             is needed. These devices are called RD0: to RDn: and for high
  77.             density disks RH0: to RHn:. CheckX can automatically mount
  78.             these or you may mount them before calling the program.
  79.             The number n depends on the archiver depth, so normally RD1:
  80.             should be the highest one really needed.
  81. NOTRACKCUT  This prevents unarchiving of cutted archives. Splitted
  82.             DMS-Archives may produce strange errors, but can be checked
  83.             correctly, when the two parts are directly after another (e.g.
  84.             no other track archive is between them). In this case the first
  85.             file shows some XPKCERR_READWRITE and the second one the
  86.             correct stuff. I checked EuroScene1 CD which has a lot cutted
  87.             archives and newest xfdmaster.library had no problems, so
  88.             probably this option is not needed anymore.
  89. DEBUG       Should not be used normally. This brings the normal output to
  90.             serial debugging terminal or catcher tools like Sushi. This
  91.             allows a lot easier to detect files producing hits.
  92.  
  93. CheckX has following return values:
  94.  0  - all ok
  95.  5  - either no virus checking possible or virus found
  96.  20 - an error occured and CheckX was unable to do anything
  97.  
  98. CheckX cannot scan files, which are read-protected. You get CheckX error 4
  99. as result in that case. Unprotect files and scan again when you want. For
  100. files contained in archives, the protection bits are ignored.
  101.  
  102. CheckX is completely reentrant and may work fine twice or more times
  103. parallel (You can set the pure file protection bit and make it resident),
  104. with one exception: Destination Disks (RDn: or RHn:) can be accessed only
  105. by one tool! So when source path contains disk archives, start only one
  106. copy of CheckX or use NOUNTRACK! It is not recommended to call it multiple
  107. times as CheckX normally needs lots of memory.
  108.  
  109. This is a batch tool, so drink a coffee or two or three during its work.
  110. Check the logfile afterwards. Use a text-editor and scan case sensitive
  111. for "-Virus" and you get lines which a related to viruses (and mostly
  112. only the important lines). A scan with "XFD-", "XAD-", "CheckX-" or
  113. "-Error" brings lines which produced errors.
  114.  
  115. The complete number of found viruses is logged at the file end, if the
  116. scan found some of them. Also the scan time and the number of errors
  117. (if some appeared) is logged.
  118.  
  119. If the permanent file scrolling slows down your computer try setting the
  120. output stream to a raw mode display using following redirect command:
  121. ">RAW:0/11/640/50/CheckX-Output/AUTO/CLOSE/WAIT".
  122. To get CheckX really silent either use LOG option and call CheckX with
  123. QUIET or redirect normal output into logfile with ">filename".
  124.  
  125. CheckX detects all the viruses found by xvs.library, which contains the
  126. complete antivirus knowledge of VirusZ utility by Georg Hörmann. CheckX
  127. cannot detect viruses in memory or remove detected viruses. You still
  128. need antivirus software like VirusZ, VT or Virus_Checker. I always run
  129. VirusZ in the background to check for viruses.
  130. CheckX also scans disk archive information texts for packers and viruses
  131. and also bootsectors of dearchived disks.
  132.  
  133. Error 11 (Could not check for virus) mostly means, that the files is a bit
  134. to large and such files are normally archives only. So in most cases this
  135. error is harmless!
  136.  
  137. If there are serious errors, please report them, but CheckX has a long
  138. way of development and I hope it is really stable now (as well as
  139. xfdmaster.library is now).
  140. Send me files, which cause the system to bring Enforcer/MungWall/PatchWork
  141. Hits or crash the computer. If the files are larger, please contact me
  142. first.
  143.  
  144. This program is Freeware. Use it as you want, but WITHOUT ANY WARRANTY!
  145.  
  146. Contact me at:
  147.  
  148. ************************************************************************
  149. * snail-mail:                  * e-mail:                               *
  150. *   Dirk Stoecker              *   stoecker@amigaworld.com             *
  151. *   Geschwister-Scholl-Str. 10 *   dstoecker@gmx.de                    *
  152. *   01877 Bischofswerda        * world wide web:                       *
  153. *   GERMANY                    *   http://home.pages.de/~Gremlin/      *
  154. * phone:                       * pgp key:                              *
  155. *   GERMANY +49 (0)3594/706666 *   get with finger or from WWW pages   *
  156. ************************************************************************
  157.  
  158.